home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 2.toast / pc / sample code / sound / audiocodec / readme < prev    next >
Encoding:
Text File  |  2000-09-28  |  2.8 KB  |  63 lines
  1. README - AudioCodec
  2.  
  3. This is a Sound Manager codec example. It will create a compressor and 
  4. decompressor supporting the uLaw format. This compressor is a built-in 
  5. codec already present in the Sound Manager. To install this example it 
  6. would require the version to be greater than the one already installed 
  7. by the Sound Manager. The example has a high version of 5.0 only for 
  8. this reason.
  9.  
  10. Use the latest QuickTime interfaces, which includes the "ComponentIncludes" headers.
  11.  
  12. Keep your data in the component globals long word aligned for best performance.
  13.  
  14. The kSoundComponentManufacturer is set to '????' and should be set to 
  15. your company's four char code. It's up to you to create this.
  16.  
  17. Your compression format needs a new four char code as well. The constant 
  18. kCodecFormat is where you define this. You should report your format to 
  19. Apple so that it can be included in the Sound Manager interfaces.  Note 
  20. that all lower-case codes are reserved for Apple's use.  Your code must
  21. have at least one non-lowercase character.
  22.  
  23. A set of tables has been used to improve the performance of these codecs.
  24. These tables are created as resources, which get loaded by the component's
  25. Open method. Then they're used as part of the globals. Using a resource 
  26. in this manner avoids the difficulties of creating static globals which 
  27. require dependacies on the target OS runtime.
  28.  
  29. Windows only
  30.  
  31. You will need to open the .mak file as a MSDEV project, and then modify
  32. the include paths and library paths by hand (Build/Settings) to match
  33. wherever it is that you have your headers and libs.  Don't forget to 
  34. modify the include paths on the Rez command line in the Custom Build
  35. settings for uLawCodec.r (both Release and Debug).  On that same command 
  36. line, you will also need to put in the full path to Rez.exe on your system.
  37.  
  38. Mac only
  39.  
  40. Linker gives the warning, "entry-point __uLawDecompComponentDispatchRD is 
  41. not a descriptor".  This is normal due to the nature of creating PowerPC 
  42. components. The entry point of a component has to be a RoutineDescriptor, 
  43. which is a structure, not code.
  44.  
  45. You can build a debug and a release version of the codec. To build both 
  46. choose "Build All" as the current target.
  47.  
  48. Once the codec is built, you can drag it to the "Reinstaller" utility or 
  49. restart your system with the codec in the extensions folder.
  50.  
  51. Source level debugging is a little bit of a challenge. Since the Sound 
  52. Manager runs at interrupt level, you cannot source level debug the code. 
  53. You can use MoviePlayer to "Export" a sound file which does not run at 
  54. interrupt level. Choose the target such as "Compressor PPC Debug" and then
  55. "Run" and set your break points. Drag the built codec file to Reinstaller 
  56. to install the new component. Open an AIFF file (or any movie file with 
  57. audio) in MoviePlayer and then choose Export. Select your codec as the 
  58. compressor type.
  59.  
  60.  
  61. Enjoy,
  62. QuickTime Team
  63.